.. _cmmStSetPosition:

cmmStSetPosition
========================
------------------------

SYNOPSIS
```````````

.. code-block:: none

    VT_I4 cmmStSetPosition(
        [in] VT_I4 Axis, [in] VT_I4 Target, 
        [in] VT_R8 Position
        )

     
DESCRIPTION
```````````````

- 지정한 채널의 지정한 카운터의 값을 새로이 설정합니다. 단, 이때 지정하는 카운터값의 단위는 “Unit distance”에
  의해 정의되는 논리적 거리 단위입니다.
  이 함수는 카운터의 값을 지정하는 매개 변수(媒介變數)가 논리거리 단위라는 것을 제외하고는 cmmStSetCount() 
  함수와 동일합니다.



PARAMETER
```````````

- Axis: 축번호. 축번호는 상수값으로 [cmX1] 부터 0 번째 축을 기준 축으로 임의의 축을 설정할 수 있습니다.

\

- Target : 설정할 카운터 번호. 이 값은 다음의 4 가지 값중의 하나이어야 합니다.

.. csv-table::
  :widths: 10 85
  :header-rows: 1
  :stub-columns: 0

  Value, Meaning
  0 또는 cmCNT_COMM, Command Counter
  1 또는 cmCNT_FEED, Feedback Counter
  2 또는 cmCNT_DEV, Deviation Counter: Command 와 Feedback counter 의 편차 카운터
  3 또는 cmCNT_GEN, General Counter: 사용자의 정의에 따라 여러가지 용도로 사용될 수 있는 카운터

\

- Position : 대상 카운터에 설정될 값. 단, 이 값은 논리적 거리 단위로 설정하여야 합니다.


RETURN VALUE
`````````````
.. csv-table::
  :widths: 10 85
  :header-rows: 1
  :stub-columns: 0

  Value, Meaning
  음수, 수행 실패
  cmERR_NONE, 수행 성공


REFERENCE
```````````

- 논리적 거리 단위는 cmmCfgSetUnitDist() 함수에 의해 결정됩니다.

EXAMPLE
```````````

- 예제는 cmmStSetCount를 참고해주세요.

.. seealso:: :ref:`cmmStSetCount`